Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Embedding Controls /

SetControlSupervisor

NEW WITH THE APPEARANCE MANAGER

Routes mouse-down events to the embedder control.

pascal OSErr SetControlSupervisor (
                     ControlHandle inControl,
                     ControlHandle inBoss);

inControl

On input, a handle to an embedded control.

inBoss

On input, a handle to the embedder control that you wish to route mouse-down events to.

function result

A result code. The result code errControlIsNotEmbedder indicates that the control specified in the inBoss parameter is not an embedder control. For a list of other result codes, see "Result Codes".

DISCUSSION

The SetControlSupervisor function allows an embedder control to respond to mouse-down events occurring in its embedded controls.

An example of a standard control that uses this function is the radio group control. Mouse-down events in the embedded controls of a radio group are intercepted by the group control. (The embedded controls in this case must support radio behavior; if a mouse-down event occurs in an embedded control within a radio group control that does not support radio behavior, the control tracks normally and the group is not involved.) The group handles all interactions and switches the embedded control's value on and off. If the value of the radio group changes, TrackControl or HandleControlClick will return the kControlRadioGroupPart part code. If the user tracks off the radio button or clicks the current radio button, kControlNoPart is returned.

SEE ALSO

"Embedding Controls".

"Appearance Manager Gestalt Selector Constants".